'''
访问数据库
    |-访问SQLite

SQLite介绍
    SQLite是一种嵌入式数据库，它的数据库就是一个文件。

    由于SQLite本身是C写的，而且体积很小，所以，经常被集成到各种应用程序中，甚至在iOS和Android的App中都可以集成。

    Python就内置了SQLite3，所以，在Python中使用SQLite，不需要安装任何东西，直接使用。

小结
    在Python中操作数据库时，要先导入数据库对应的驱动，然后，通过Connection对象和Cursor对象操作数据。

    要确保打开的Connection对象和Cursor对象都正确地被关闭，否则，资源就会泄露。

    如何才能确保出错的情况下也关闭掉Connection对象和Cursor对象呢？请回忆try:...except:...finally:...的用法。
'''
import sqlite3

def common():
    # 连接到SQLite数据库
    # 数据库文件是test.db
    # 如果文件不存在，会自动在当前目录创建:
    conn = sqlite3.connect('test.db')

    # 创建一个Cursor:
    cursor = conn.cursor()

    # 执行一条SQL语句，创建user表:
    cursor.execute('''CREATE TABLE user (id VARCHAR(20) PRIMARY KEY, name VARCHAR(20))''')

    # 继续执行一条SQL语句，插入一条记录:
    cursor.execute('''INSERT INTO user (id, name) VALUES ('1', 'Michael')''')

    # 通过rowcount获得插入的行数:
    print(cursor.rowcount)

    # 关闭Cursor:
    cursor.close()

    # 提交事务:
    conn.commit()

    # 关闭Connection:
    conn.close()

def select():
    # 连接数据库
    conn = sqlite3.connect('test.db')

    # 获取游标
    cursor = conn.cursor()

    # 执行查询语句:
    cursor.execute('''SELECT * FROM user WHERE id=?''', ('1',))

    # 获得查询结果集:
    values = cursor.fetchall()
    print(values)

    # 关闭Cursor:
    cursor.close()

    # 关闭Connection:
    conn.close()

if __name__ == '__main__':

    # common()

    select()

'''
使用Python的DB-API时，只要搞清楚Connection和Cursor对象，打开后一定记得关闭，就可以放心地使用。

使用Cursor对象执行insert，update，delete语句时，执行结果由rowcount返回影响的行数，就可以拿到执行结果。

使用Cursor对象执行select语句时，通过featchall()可以拿到结果集。结果集是一个list，每个元素都是一个tuple，对应一行记录。

如果SQL语句带有参数，那么需要把参数按照位置传递给execute()方法，有几个?占位符就必须对应几个参数，例如：

    cursor.execute('select * from user where name=? and pwd=?', ('abc', 'password'))
    
SQLite支持常见的标准SQL语句以及几种常见的数据类型。具体文档请参阅SQLite官方网站。
'''





